home *** CD-ROM | disk | FTP | other *** search
XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmSSSSccccrrrreeeeeeeennnn - The Screen widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////SSSSccccrrrreeeeeeeennnn....hhhh>>>> VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents version 1.2 of the Motif library. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The XmScreen object is used by Motif widgets to store information that is specific to a screen. It also allows the toolkit to store certain information on widget hierarchies that would otherwise be unavailable. Each client has one XmScreen object for each screen that it accesses. An XmScreen object is automatically created when the application creates the first shell on a screen (usually accomplished by a call to XXXXttttAAAAppppppppIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee or XXXXttttAAAAppppppppCCCCrrrreeeeaaaatttteeeeSSSShhhheeeellllllll). It is not necessary to create an XmScreen object by any other means. An application can use the function XXXXmmmmGGGGeeeettttXXXXmmmmSSSSccccrrrreeeeeeeennnn to obtain the widget ID of the XmScreen object for a given screen. An application cannot supply initial values for XmScreen resources as arguments to a call to any function that creates widgets. The application or user can supply initial values in a resource file. After creating the first shell on the screen, the application can use XXXXmmmmGGGGeeeettttXXXXmmmmSSSSccccrrrreeeeeeeennnn to obtain the widget ID of the XmScreen object and then call XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss to set the XmScreen resources. CCCCllllaaaasssssssseeeessss Screen inherits behavior and resources from CCCCoooorrrreeee. The class pointer is xxxxmmmmSSSSccccrrrreeeeeeeennnnCCCCllllaaaassssssss. The class name is XXXXmmmmSSSSccccrrrreeeeeeeennnn. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in an ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC prefix and use the remaining letters. To specify one of the defined values for a resource in an ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the Page 1 (printed 4/30/98) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) given resource can be set at creation time (C), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is not applicable (N/A). XXXXmmmmSSSSccccrrrreeeeeeeennnn RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ________________________________________________________________________________________________________ XmNdarkThreshold XmCDarkThreshold int dynamic C XmNdefaultCopyCursorIcon XmCDefaultCopyCursorIcon Widget NULL CSG XmNdefaultInvalidCursorIcon XmCDefaultInvalidCursorIcon Widget NULL CSG XmNdefaultLinkCursorIcon XmCDefaultLinkCursorIcon Widget NULL CSG XmNdefaultMoveCursorIcon XmCDefaultMoveCursorIcon Widget NULL CSG XmNdefaultNoneCursorIcon XmCDefaultNoneCursorIcon Widget NULL CSG XmNdefaultSourceCursorIcon XmCDefaultSourceCursorIcon Widget NULL CSG XmNdefaultValidCursorIcon XmCDefaultValidCursorIcon Widget NULL CSG XmNfont XmCFont XFontStruct * NULL CSG XmNforegroundThreshold XmCForegroundThreshold int dynamic C XmNhorizontalFontUnit XmCHorizontalFontUnit int dynamic CSG XmNlightThreshold XmCLightThreshold int dynamic C XmNmenuCursor XmCCursor String arrow C XmNmoveOpaque XmCMoveOpaque Boolean False CSG XmNunpostBehavior XmCUnpostBehavior unsigned char XmUNPOST_AND_REPLAY CSG XmNverticalFontUnit XmCVerticalFontUnit int dynamic CSG XXXXmmmmNNNNddddaaaarrrrkkkkTTTThhhhrrrreeeesssshhhhoooolllldddd An integer between 0 and 100, inclusive, that specifies a level of perceived brightness for a color. If the perceived brightness of the background color is below this level, Motif treats the background as "dark" when computing default shadow and select colors. If this resource is specified for a particular screen, it applies to widgets created on that screen; otherwise it applies to widgets created on all screens. The default value is implementation specific. XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttCCCCooooppppyyyyCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn Specifies the DragIcon used during a drag operation when the operation is a copy and no other pixmap is specified by the application. If NULL, a system default icon is used. XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttIIIInnnnvvvvaaaalllliiiiddddCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn Specifies the DragIcon used to indicate that the cursor is over an invalid drop site during a drag operation when no other pixmap symbol is specified by the application. If NULL, a system default icon is used. XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttLLLLiiiinnnnkkkkCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn Specifies the DragIcon used during a drag Page 2 (printed 4/30/98) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) operation when the operation is a link and no other pixmap is specified by the application. If NULL, a system default icon is used. XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttMMMMoooovvvveeeeCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn Specifies the DragIcon used during a drag operation when the operation is a move and no other pixmap is specified by the application. If NULL, a system default icon is used. XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttNNNNoooonnnneeeeCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn Specifies the DragIcon used to indicate that the cursor is not over a drop site during a drag operation when no other pixmap is specified by the application. If NULL, a system default icon is used. XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttSSSSoooouuuurrrrcccceeeeCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn Specifies the depth-1 pixmap used as a cursor when an XXXXmmmmNNNNssssoooouuuurrrrcccceeeeCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn is not provided by the DragContext, or it is not usable. If NULL, a system default icon is used. XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttVVVVaaaalllliiiiddddCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn Specifies the DragIcon used to indicate that the cursor is over a valid drop site during a drag operation when no other pixmap is specified by the application. If NULL, a system default icon is used. XXXXmmmmNNNNffffoooonnnntttt Specifies a font for use in computing values for XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt and XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt. When an application is initialized, this resource can be supplied in a resource file or through the standard command line options ----ffffnnnn, ----ffffoooonnnntttt, and ----xxxxrrrrmmmm. XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnnddddTTTThhhhrrrreeeesssshhhhoooolllldddd An integer between 0 and 100, inclusive, that specifies a level of perceived brightness for a color. If the perceived brightness of the background color is equal to or below this level, Motif treats the background as "dark" when computing the default foreground and highlight colors. If the perceived brightness of the background color is above this level, Motif treats the background as "light" when computing the default foreground and highlight colors. When the background is "dark", the default foreground and highlight is white; when the background is "light", the default foreground and highlight is black. If this resource is specified for a Page 3 (printed 4/30/98) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) particular screen, it applies to widgets created on that screen; otherwise, it applies to widgets created on all screens. The default value is implementation specific. XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt Specifies the horizontal component of the font units used by XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttUUUUnnnniiiittttssss, and is used to interpret the values of geometry resources when the XXXXmmmmNNNNsssshhhheeeellllllllUUUUnnnniiiittttTTTTyyyyppppeeee resource of VendorShell or the XXXXmmmmNNNNuuuunnnniiiittttTTTTyyyyppppeeee resource of Gadget, Manager, or Primitive has the value XXXXmmmm111100000000TTTTHHHH____FFFFOOOONNNNTTTT____UUUUNNNNIIIITTTTSSSS. If no initial value is supplied for this resource, the default is computed from the font specified in XXXXmmmmNNNNffffoooonnnntttt. If no initial value is supplied for this resource or for XXXXmmmmNNNNffffoooonnnntttt, the default is 10. If a call to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss specifies a value for XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt, this resource is set to that value. If a call to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss specifies a value for XXXXmmmmNNNNffffoooonnnntttt but not for XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt, this resource is set to a value computed from the new XXXXmmmmNNNNffffoooonnnntttt. A horizontal font unit is derived from a font as follows: +o If the font has an AAAAVVVVEEEERRRRAAAAGGGGEEEE____WWWWIIIIDDDDTTTTHHHH property, the horizontal font unit is the AAAAVVVVEEEERRRRAAAAGGGGEEEE____WWWWIIIIDDDDTTTTHHHH property divided by 10. +o If the font has no AAAAVVVVEEEERRRRAAAAGGGGEEEE____WWWWIIIIDDDDTTTTHHHH property but has a QQQQUUUUAAAADDDD____WWWWIIIIDDDDTTTTHHHH property, the horizontal font unit is the QQQQUUUUAAAADDDD____WWWWIIIIDDDDTTTTHHHH property. +o If the font has no AAAAVVVVEEEERRRRAAAAGGGGEEEE____WWWWIIIIDDDDTTTTHHHH or QQQQUUUUAAAADDDD____WWWWIIIIDDDDTTTTHHHH property, the horizontal font unit is the sum of the font structure's _m_i_n__b_o_u_n_d_s._w_i_d_t_h and _m_a_x__b_o_u_n_d_s._w_i_d_t_h divided by 2.3. XXXXmmmmNNNNlllliiiigggghhhhttttTTTThhhhrrrreeeesssshhhhoooolllldddd An integer between 0 and 100, inclusive, that specifies a level of perceived brightness for a color. If the perceived brightness of the background color is above this level, Motif treats the background as "light" when computing default shadow and select colors. If this resource is specified for a particular screen, it applies to widgets created on that screen; otherwise, it Page 4 (printed 4/30/98) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) applies to widgets created on all screens. The default value is implementation specific. XXXXmmmmNNNNmmmmeeeennnnuuuuCCCCuuuurrrrssssoooorrrr Sets a variable that controls the cursor used whenever this application posts a menu. This resource can be specified only once at application startup time, either by placing it within a defaults file or by using the ----xxxxrrrrmmmm command line argument. For example mmmmyyyyPPPPrrrroooogggg ----xxxxrrrrmmmm """"****mmmmeeeennnnuuuuCCCCuuuurrrrssssoooorrrr:::: aaaarrrrrrrroooowwww"""" The menu cursor can also be selected in the program through the function XXXXmmmmSSSSeeeettttMMMMeeeennnnuuuuCCCCuuuurrrrssssoooorrrr. The following is a list of acceptable cursor names. If the application does not specify a cursor or if an invalid name is supplied, the default cursor (an arrow pointing up and to the right) is used. XXXX____ccccuuuurrrrssssoooorrrr ddddoooottttbbbbooooxxxx mmmmaaaannnn ssssiiiizzzziiiinnnngggg aaaarrrrrrrroooowwww ddddoooouuuubbbblllleeee____aaaarrrrrrrroooowwww mmmmiiiiddddddddlllleeeebbbbuuuuttttttttoooonnnn ssssppppiiiiddddeeeerrrr bbbbaaaasssseeeedddd____aaaarrrrrrrroooowwww____ddddoooowwwwnnnn ddddrrrraaaafffftttt____llllaaaarrrrggggeeee mmmmoooouuuusssseeee sssspppprrrraaaayyyyccccaaaannnn bbbbaaaasssseeeedddd____aaaarrrrrrrroooowwww____uuuupppp ddddrrrraaaafffftttt____ssssmmmmaaaallllllll ppppeeeennnncccciiiillll ssssttttaaaarrrr bbbbooooaaaatttt ddddrrrraaaappppeeeedddd____bbbbooooxxxx ppppiiiirrrraaaatttteeee ttttaaaarrrrggggeeeetttt bbbbooooggggoooossssiiiittttyyyy eeeexxxxcccchhhhaaaannnnggggeeee pppplllluuuussss ttttccccrrrroooossssssss bbbboooottttttttoooommmm____lllleeeefffftttt____ccccoooorrrrnnnneeeerrrr fffflllleeeeuuuurrrr qqqquuuueeeessssttttiiiioooonnnn____aaaarrrrrrrroooowwww ttttoooopppp____lllleeeefffftttt____aaaarrrrrrrroooowwww bbbboooottttttttoooommmm____rrrriiiigggghhhhtttt____ccccoooorrrrnnnneeeerrrr ggggoooobbbbbbbblllleeeerrrr rrrriiiigggghhhhtttt____ppppttttrrrr ttttoooopppp____lllleeeefffftttt____ccccoooorrrrnnnneeeerrrr bbbboooottttttttoooommmm____ssssiiiiddddeeee gggguuuummmmbbbbyyyy rrrriiiigggghhhhtttt____ssssiiiiddddeeee ttttoooopppp____rrrriiiigggghhhhtttt____ccccoooorrrrnnnneeeerrrr bbbboooottttttttoooommmm____tttteeeeeeee hhhhaaaannnndddd1111 rrrriiiigggghhhhtttt____tttteeeeeeee ttttoooopppp____ssssiiiiddddeeee bbbbooooxxxx____ssssppppiiiirrrraaaallll hhhhaaaannnndddd2222 rrrriiiigggghhhhttttbbbbuuuuttttttttoooonnnn ttttoooopppp____tttteeeeeeee cccceeeennnntttteeeerrrr____ppppttttrrrr hhhheeeeaaaarrrrtttt rrrrttttllll____llllooooggggoooo ttttrrrreeeekkkk cccciiiirrrrcccclllleeee iiiiccccoooonnnn ssssaaaaiiiillllbbbbooooaaaatttt uuuullll____aaaannnngggglllleeee cccclllloooocccckkkk iiiirrrroooonnnn____ccccrrrroooossssssss ssssbbbb____ddddoooowwwwnnnn____aaaarrrrrrrroooowwww uuuummmmbbbbrrrreeeellllllllaaaa ccccooooffffffffeeeeeeee____mmmmuuuugggg lllleeeefffftttt____ppppttttrrrr ssssbbbb____hhhh____ddddoooouuuubbbblllleeee____aaaarrrrrrrroooowwww uuuurrrr____aaaannnngggglllleeee ccccrrrroooossssssss lllleeeefffftttt____ssssiiiiddddeeee ssssbbbb____lllleeeefffftttt____aaaarrrrrrrroooowwww wwwwaaaattttcccchhhh ccccrrrroooossssssss____rrrreeeevvvveeeerrrrsssseeee lllleeeefffftttt____tttteeeeeeee ssssbbbb____rrrriiiigggghhhhtttt____aaaarrrrrrrroooowwww xxxxtttteeeerrrrmmmm ccccrrrroooosssssssshhhhaaaaiiiirrrr lllleeeeffffttttbbbbuuuuttttttttoooonnnn ssssbbbb____uuuupppp____aaaarrrrrrrroooowwww ddddiiiiaaaammmmoooonnnndddd____ccccrrrroooossssssss llllllll____aaaannnngggglllleeee ssssbbbb____vvvv____ddddoooouuuubbbblllleeee____aaaarrrrrrrroooowwww ddddooootttt llllrrrr____aaaannnngggglllleeee sssshhhhuuuuttttttttlllleeee XXXXmmmmNNNNmmmmoooovvvveeeeOOOOppppaaaaqqqquuuueeee Specifies whether an interactive operation that moves a window, such as tearing off and dragging a tear-off menu or moving a window in MWM, displays an outline of the window or a representation of the window itself during the move. If the value is True, the operation displays a representation of the window during the move. If the value is False, the operation displays an outline of the window. Page 5 (printed 4/30/98) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) XXXXmmmmNNNNuuuunnnnppppoooossssttttBBBBeeeehhhhaaaavvvviiiioooorrrr Specifies the behavior of an active menu posted in traversal mode when a subsequent menu button selection is made outside the posted menu. When the value is XXXXmmmmUUUUNNNNPPPPOOOOSSSSTTTT____AAAANNNNDDDD____RRRREEEEPPPPLLLLAAAAYYYY, the resource unposts the menu hierarchy and causes the server to replay the event to the window in which the pointer is located. When the value is XXXXmmmmUUUUNNNNPPPPOOOOSSSSTTTT, the resource unposts the hierarchy without replaying the event. XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt Specifies the vertical component of the font units used by XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttUUUUnnnniiiittttssss and used to interpret the values of geometry resources when the XXXXmmmmNNNNsssshhhheeeellllllllUUUUnnnniiiittttTTTTyyyyppppeeee resource of VendorShell or the XXXXmmmmNNNNuuuunnnniiiittttTTTTyyyyppppeeee resource of Gadget, Manager, or Primitive has the value XXXXmmmm111100000000TTTTHHHH____FFFFOOOONNNNTTTT____UUUUNNNNIIIITTTTSSSS. If no initial value is supplied for this resource, the default is computed from the font specified in XXXXmmmmNNNNffffoooonnnntttt. If no initial value is supplied for this resource or for XXXXmmmmNNNNffffoooonnnntttt, the default is 10. If a call to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss specifies a value for XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt, this resource is set to that value. If a call to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss specifies a value for XXXXmmmmNNNNffffoooonnnntttt but not for XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt, this resource is set to a value computed from the new XXXXmmmmNNNNffffoooonnnntttt. A vertical font unit is derived from a font as follows: +o If the font has a PPPPIIIIXXXXEEEELLLL____SSSSIIIIZZZZEEEE property, the vertical font unit is the PPPPIIIIXXXXEEEELLLL____SSSSIIIIZZZZEEEE property divided by 1.8. +o If the font has no PPPPIIIIXXXXEEEELLLL____SSSSIIIIZZZZEEEE property but has PPPPOOOOIIIINNNNTTTT____SSSSIIIIZZZZEEEE and RRRREEEESSSSOOOOLLLLUUUUTTTTIIIIOOOONNNN____YYYY properties, the vertical font unit is the product of the PPPPOOOOIIIINNNNTTTT____SSSSIIIIZZZZEEEE and RRRREEEESSSSOOOOLLLLUUUUTTTTIIIIOOOONNNN____YYYY properties divided by 1400. +o If the font has no PPPPIIIIXXXXEEEELLLL____SSSSIIIIZZZZEEEE, PPPPOOOOIIIINNNNTTTT____SSSSIIIIZZZZEEEE, or RRRREEEESSSSOOOOLLLLUUUUTTTTIIIIOOOONNNN____YYYY properties, the vertical font unit is the sum of the font structure's _m_a_x__b_o_u_n_d_s._a_s_c_e_n_t and _m_a_x__b_o_u_n_d_s._d_e_s_c_e_n_t divided by 2.2. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss PPPPaaaaggggeeee 6666 ((((pppprrrriiiinnnntttteeeedddd 4444////33330000////99998888)))) XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))) All of the superclass resources inherited by XmScreen are designated N/A (not applicable). RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN CCCCoooorrrreeee((((3333XXXX)))), XXXXmmmmDDDDiiiissssppppllllaaaayyyy((((3333XXXX)))), and XXXXmmmmGGGGeeeettttXXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))). Page 7 (printed 4/30/98) 
